home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / codeprnt / vbppdm / readme.txt < prev    next >
Encoding:
Text File  |  1995-06-17  |  14.4 KB  |  377 lines

  1.         Pretty Printer for Visual Basic 
  2.                Copyright 1993-1995     
  3.                All rights reserved.    
  4.                   
  5.                  ***SUPPORT***
  6.      
  7.      CompuServe:  GO AARDVARK, 24 Hours-A-Day
  8.      E-mail: 73173.1137@compuserve.com, 24 Hours-A-Day
  9.      Fax:  1-201-833-1216, 24 Hours-A-Day   
  10.      Voice:  1-610-524-2589, M-F, 9 AM - 6 PM ET 
  11.  
  12.                ***File Contents***
  13.  
  14.             Overview
  15.             System Requirements
  16.             Installation
  17.             Getting Started
  18.             New Features
  19.             Upgrading  
  20.             Compatibility Issues
  21.             Frequently Asked Questions
  22.             File Distribution
  23.  
  24.  
  25.     ***Pretty Printer for Visual Basic Overview***
  26.  
  27. Thank you for your interest in Pretty Printer. Together, 
  28. Pretty Printer and You - the Visual Basic programmer, have
  29. the capability to produce the most professional listings in
  30. the business.
  31.  
  32.      Pretty Printer is 100% Visual Basic(R) code, and 
  33. demonstrates the enormous power Visual Basic brings to the 
  34. Windows(tm) developer.  At the same time, this new version
  35. of Pretty Printer expands and strengthens Visual Basic's
  36. code printing capabilities with a host of new features.
  37.  
  38.      Pretty Printer's black and white output is crisp, 
  39. neat, and very readable.  Selected code components can be 
  40. highlighted using the program's "grayscale like" background 
  41. feature.  Whether you use a laser, ink jet or dot matrix, 
  42. Pretty Printer will produce a listing you will be proud to 
  43. display.
  44.  
  45. Pretty Printer gives you a wide choice of fonts, 
  46. styles and formats to further professionalize your output.
  47. You may arrange the page layout to fit your needs,
  48. including setting margins, indentations, number of columns,
  49. page headings, and page breaks.  Connectors may be inserted
  50. to bracket your loop and logic code statements, making it
  51. easier to find errors or to mark reusable code.  Pretty
  52. Printer is what you have needed to catch that hard to track
  53. down bug, or to impress that very important client.
  54.  
  55. Using a color capable printer, you can produce code 
  56. listings that highlight Visual Basic's keywords, user 
  57. variables, comments, literals, and page headings - each in 
  58. a different color.
  59.  
  60.      While Pretty Printer was designed for use with Visual 
  61. Basic 3.0, it will produce enhanced listings for other 
  62. versions of Visual Basic - and other Basic dialects.  Pretty
  63. Printer is compatible with all printers supported by Windows.
  64.  
  65.             ***System Requirements***
  66.  
  67. Required: MSDOS 3.3 or later version.
  68.           Windows 3.1x, Windows for Workgroups
  69.           or Windows NT and compatibles.
  70.  
  71.  
  72.               ***Installation***
  73.  
  74.      Insert the disk in a floppy drive. If you have not already
  75. done so, start Microsoft Windows.  Choose "Run" from the
  76. Program Manager File menu.  At the command line type A:\Setup
  77. (If "A" is not your floppy drive letter, substitute the
  78. appropriate letter).  Follow the setup instructions on the
  79. screen.
  80.  
  81.      If you are upgrading an earlier version of Pretty
  82. Printer, follow the same instructions - the older files
  83. will be over-written.         
  84.  
  85. Upgrade Note: In Pretty Printer version 2.1 VBPP.KEY was
  86. replaced by BASICLAN.KEY.  Upon installation VBPP.KEY will
  87. not be overwritten.  You may delete the file to save disk
  88. space, however, its presence will have no effect on running
  89. the current version of Pretty Printer. 
  90.   
  91. If you have problems with the installation, check the
  92. "Compatibility Issues" select below.  Also check to see if
  93. your device drivers and *.DLL files are current.  Updating
  94. drivers and *.DLL files to the latest versions has fixed 
  95. all sorts of odd problems.  If you can not resolve your 
  96. installation problems, contact AARDVARK Software for 
  97. assistance.    
  98.              
  99.              ***Getting Started***
  100.      
  101.      To print a chosen project or file, open Pretty 
  102. Printer.  After the "About Notice" has cleared the screen, 
  103. an Open File Common Dialog Box will appear.  Select the 
  104. project or file you wish to open, then click the "OK" button.
  105. To print immediately using Pretty Printer's default 
  106. settings, and Windows default printer, click on the File 
  107. Menu and select Print.  A print option box will appear, 
  108. make your selection and click "OK".  That's all there is to 
  109. it!
  110.  
  111.      Pretty Printer prints ASCII text files.  The Visual 
  112. Basic Programmer's Guide outlines the very real advantages 
  113. of saving your files in text format, and is worth reading. 
  114. To get your code into text format do one of the following:
  115.  
  116. (1) For a new project, go to the Visual Basic 
  117. Options Menu - Environment Dialog Box.  Select 
  118. the option to save all of your project's code in 
  119. text format.
  120. (2) To convert existing code files saved in binary
  121. format, go to the Visual Basic File Menu, and
  122. select the Save File As entry.  When the dialog
  123. box appears, check the Save as Text box, then
  124. save the file using standard Windows conventions.
  125.  
  126.      To refine the printed output, click on the Color, Font 
  127. or Format items from Pretty Printer's Option Menu; or 
  128. select Page Layout from the File Menu.  To get a better 
  129. understanding of these, and other features supported by 
  130. Pretty Printer, use the Help Search Utility, the Help
  131. Contents screen , or press F1 for context-sensitive 
  132. help.
  133.  
  134.        
  135.             ***New Features***
  136.  
  137. New features in 2.1a (6/95)
  138.      Time required to load / read (parsing) code file(s) reduced by 40%
  139.      Splash screen implemented
  140.      System Info option added to About dialog
  141.  
  142. New features in 2.1 (2/95)
  143.      Code line continuations
  144.      Multi-column printing
  145.      User heading
  146.      Connectors without Auto-Indent option 
  147.      Upgraded Help File
  148.      CompuServe Forum Support
  149.      Bugs resolved 
  150.  
  151. New features in 2.0 (6/94)
  152.      Connectors (For/Next, Do/Loop, If/ElseIf/End If)
  153.      Project File handling
  154.      On-line help
  155.      Orphan handling
  156.      User Interface improvements
  157.      International - Metric margin settings
  158.      Option for bold proc separator
  159.      Bugs resolved
  160.  
  161. New features in 1.2 (2/94)
  162.      Ability to specify contents of page headings
  163.      Long tokens are wrapped instead of truncated
  164.      Prints table of contents as an option
  165.      User interface changed (improved)
  166.      Paint and setfocus eliminated where not needed
  167.  
  168. New Features in 1.1 (1/94)
  169.      Procedure selection (Sub/Function)
  170.      Margin selection
  171.      Option sets saved for each printer
  172.      Automatic indentation option
  173.      Option to suppress form description printing.
  174.      Easier setting of all options
  175.  
  176.           ***Important Upgrading Information***
  177.  
  178. All upgraders to 2.1 (from 1.0, 1.1, 1.2, 2.0)
  179. VBPP 2.1 VBPP.INI file switches are coded to "yes/no."
  180. In previous versions, VBPP.INI switches were coded to -1/0.
  181. VBPP 2.1 will read either designation.  Earlier versions
  182. equate both "yes" and "no" as false.  If, after installing and
  183. running version 2.1, you return to an earlier version of Pretty
  184. Printer, you will lose your switch options.  This may lead to
  185. confusion as no default values will be set either.  If you
  186. anticipate running earlier versions of Pretty Printer it may be
  187. desirable to copy the current VBPP.INI file before installing
  188. Pretty Printer 2.1.
  189. If you modified VBPP.KEY, you must make similar 
  190. modifications in the new BASICLAN.KEY.  The old VBPP.KEY file 
  191. will not work.
  192.  
  193.        ***Pretty Printer for Visual Basic Compatibility Issues***
  194.  
  195. 1 - On the Ultra Script postscript software emulator from 
  196. QMS by PM Ware V3.01, a few characters are lost at the 
  197. beginning of each line.  This appears to be their problem.
  198.  
  199. 2 - Under HP dashboard + a network, one user has 
  200. experienced system hangs and file/path not found.  Runs OK 
  201. from an icon.
  202.  
  203. 3 -  ATI VESA local video cards with the Mach 32 chip.  
  204. With some driver versions, the print on a color printer may 
  205. become garbled.  Specifically, on an HP Deskjet 500C, parts 
  206. of letters will not print.  Solution, install the latest 
  207. ATI driver.
  208.  
  209. 4 - When installing VBPP you can get Warning- Cannot copy 
  210. file A:\DDEML.DL_ since the destination file is already in 
  211. use.  Ignore the message - hit OK.
  212.  
  213. 5 - A "Memory overflow" message on the hardware control 
  214. panel of an HP LJ III with 1 Meg of memory can occur.  The 
  215. standard Windows 3.1 HP LJ III driver uses 1.5 MB blocks 
  216. which can cause memory overflow on certain types of print 
  217. jobs.  The bypass is to define the printer as an HP LJ 
  218. Series II printer and setting it to use 512k byte blocks or 
  219. to upgrade the printer to 1.5MB.
  220.  
  221. 6 - Table of Contents out of sequence.  By default Visual
  222. Basic sequences module procedures in alphanumeric order
  223. until the module reaches some indeterminate size. At that
  224. point Visual Basic adds new module procedures to the top
  225. of the list.  VBPP prints code and Table of Contents in
  226. the order encountered.   
  227.  
  228. 7 - A user reported a GPF using IBM Lexmark printer with 
  229. certain settings.  This is a probable problem in VB or the 
  230. printer driver.
  231.  
  232. 8 - Using the Print Setup causes a blank page to be printed 
  233. and the selected printer to become the system default 
  234. printer.  This is a 'feature' of VB's printer interface.
  235.  
  236. 9 - System hangs after print requested, noticed when TEMP 
  237. set to a Ram drive. This can be due to insufficient space 
  238. for printer TEMP files. To bypass, increase the size of the 
  239. RAM drive, or point the TEMP directory to a hard drive with 
  240. more space.  You can also decrease the size of the print 
  241. file by using printer fonts (rather than true-type), and 
  242. remove background colors.
  243.  
  244. 10 - Multiple statements per line can cause indent or 
  245. connector problems.  If problems are encountered, split the 
  246. lines.
  247.  
  248. 11 - Very large tokens and programs can abort processing.  
  249. The maximum token size is 4K, with a limit of 32K tokens 
  250. per program.
  251.  
  252.     ***Frequently Asked Questions***
  253.  
  254. Q:  Do I need a color printer to run VBPP?
  255.  
  256. A:  No, VBPP will make your listings look better whether 
  257. you have a black & white or a color printer.  Even on black 
  258. & white printers, you can use bolding, italics, different 
  259. fonts, and different sizes to make your listings more 
  260. readable.  On color printers, the results are outrageous.
  261.  
  262. Q:  What printers does VBPP support?
  263.  
  264. A:  VBPP should work with any printer that Windows 
  265. supports.  It has been used with impact printers, laser 
  266. printers, ink jets, and even fax modems.
  267.  
  268. Q:  Does VBPP require Windows?
  269.  
  270. A:  Yes.  It has been tested on Windows 3.1, Windows for 
  271. Workgroups, Windows NT 3.5, OS/2 2.1 and beta versions 
  272. of Windows 95.  It should work on other versions of Windows.
  273.  
  274. Q:  Does VBPP require Visual Basic 3.0?
  275.  
  276. A:  VBPP does not require any version of Visual Basic to be 
  277. installed, it is self-contained and only requires Windows.
  278.  
  279. Q:  What dialects of BASIC does VBPP handle?
  280.  
  281. A:  VBPP is primarily designed for Visual Basic for
  282. Windows 3.0, and its keyword lists are set to that dialect.
  283. It performs well with Visual Basic for Windows 1.0 and 2.0;
  284. Visual Basic for DOS, Quick BASIC, QBasic, and even
  285. GWBASIC code.  It has some knowledge of Visual Basic for
  286. Applications, Word Basic and Access Basic.
  287.  
  288. Q:  Is the product guaranteed?
  289.  
  290. A:  Yes, if you are not satisfied, you may return it within 
  291. 90 days for a full refund.
  292.  
  293. Q:  Is Pretty Printer integrated into Visual Basic?  How do 
  294. I print with Pretty Printer.
  295.  
  296. A:  Pretty Printer is a separate application from Visual 
  297. Basic and runs in a separate window.  Once you have started 
  298. Visual Basic and Pretty Printer, you can switch to between 
  299. them by using standard Windows commands such as ALT+TAB.  
  300. This separation precludes problems in one product from 
  301. causing problems in the other.
  302.  
  303. Q:  Does Pretty Printer produce an index or a cross-
  304. reference.
  305.  
  306. A:  Pretty Printer produces a Table of Contents which lists 
  307. the procedures (Subs and Functions) in a module in the 
  308. order they appear.  (It is not an index because an index is 
  309. alphabetized.  A variable cross-referencer is another type 
  310. of product - Pretty Printer is not a cross-referencer.)
  311.  
  312. Q:  Does Pretty Printer work on binary files?
  313.  
  314. A:  Pretty Printer uses text files.  That means that you 
  315. should set your Options/Environment/Save As Default Format 
  316. to Text.  Existing projects can be quickly converted by 
  317. using File/Save As/ and checking the "Save as Text" box.
  318. Whether you use Pretty Printer or not, Microsoft advises 
  319. that you use text rather than binary format.  If the binary 
  320. format is corrupted, it is unrecoverable, while the text 
  321. format can often be repaired with a text editor.
  322.  
  323. Q:  Can the demo version be enabled as production?  Can you 
  324. electronically ship the production version to me?
  325.  
  326. A:  While the demo version cannot be changed to production, 
  327. we can e-mail the production version of the product to you 
  328. via CompuServe for an additional $10.00. We need your 
  329. CompuServe address. Sorry, we cannot ship to Internet, 
  330. Prodigy, America OnLine or other services.  We still ship 
  331. the regular version to you.  
  332.  
  333.  
  334.            ***File Distribution***
  335.  
  336. Pretty Printer for Visual Basic SETUP installs files on your
  337. hard disk as follows:
  338.  
  339. VBPP directory:
  340. README.TXT        This file.
  341. TEST1.BAS            Example for, and to test VBPP.
  342. TEST2.FRM           Example for, and to test VBPP.
  343. VBPP.HLP              Help file.
  344. VBPP.EXE              Executable file.
  345. BASICLAN.KEY      Keyword file.
  346. WINSIZE.DLL         Help support file.
  347.  
  348. Windows\System directory
  349. ANIBUTION.VBX 
  350. CMDIALOG.VBX
  351. COMMDLG.DLL
  352. VBRUN300.DLL
  353.  
  354. These files are used by the setup processor and are 
  355. normally present in the Windows\System directory:
  356.  
  357. DDEML.DLL
  358. VER.DLL
  359.  
  360. Please send us your comments, suggestions and bug reports.
  361. If you like what we do, please tell your friends.  If you
  362.         don't like what we do, please tell us.
  363.            
  364.             ***************************************************
  365.             * Pretty Printer for Visual Basic                 *
  366.             * Copyright 1993-1995                                  *
  367.             * AARDVARK Software, Inc.                        *
  368.             * 972 Sheffield Road                                      *
  369.             * Teaneck, NJ 07666                                      *
  370.             * Voice: 1-201-833-4355                                *
  371.             * Fax: 1-201-833-1216                                    *
  372.             * CIS: GO AARDVARK                                   *
  373.             * E-mail: 70544.1372@compuserve.com  *
  374.             * All rights reserved.                                       *
  375.             ****************************************************
  376.  
  377.